
 
 F u n c t i o n :   R o v i n g T a b I n d e x ( o b j e c t K e y V a l u e M a p ) 
 
 
 
 D e s c r i p t i o n :   C r e a t e s   a   c o n f i g u r a b l e   R o v i n g T a b I n d e x   o b j e c t   t h a t   w i l l   a u t o m a t i c a l l y   c o n f i g u r e   a c c e s s i b l e   k e y b o a r d   s u p p o r t   f o r   a s s o c i a t e d   e l e m e n t s ,   w h i c h   w i l l   p r o v i d e   o n e   t a b   s t o p   a n d   m a n a g e   f o c u s   b e t w e e n   t h e m   u s i n g   t h e   a r r o w   k e y s   a n d   o t h e r   c o m m o n   k e y s t r o k e s . 
 
 
 
 R e t u r n s :   R T I   I n s t a n c e   O b j e c t . 
 
 
 
 R e q u i r e s   m o d u l e :   " R o v i n g T a b I n d e x " 
 
 
 
 N o t e :   T h e   f i r s t   p a r a m e t e r   m u s t   i n c l u d e   a   c o n f i g u r a t i o n   k e y   v a l u e   m a p .   T h o u g h   R o v i n g T a b I n d e x   w i l l   w o r k   o n   a n y   c o l l e c t i o n   o f   a s s o c i a t e d   D O M   e l e m e n t s ,   i t   i s   v i t a l l y   i m p o r t a n t   t o   e n s u r e   t h a t   A R I A   w i d g e t   c o n s t r u c t s   a r e   c o r r e c t l y   r e f e r e n c e d   w h e n   s e t t i n g   u p   t h i s   f u n c t i o n a l i t y .   T o   d o   s o   c o r r e c t l y   i n   a c c o r d a n c e   w i t h   t h e   A R I A   s p e c i f i c a t i o n ,   a l l   c h i l d   e l e m e n t   A R I A   w i d g e t   r o l e s   m u s t   o n l y   b e   i n c l u d e d   w i t h i n   t h e   f o c u s a b l e   e l e m e n t s   t h a t   a r e   m e a n t   t o   b e   a c t i o n a b l e .   A d d i t i o n a l l y ,   w e n   s e t t i n g   t h e   n o d e s   p r o p e r t y   w i t h i n   t h e   R o v i n g T a b I n d e x   s e t u p ,   t h e   r e f e r e n c e d   a r r a y   m u s t   o n l y   i n c l u d e   f o c u s a b l e   e l e m e n t s   t h a t   a l r e a d y   p o s s e s s   t h e   c o r r e c t   A R I A   c h i l d   r o l e s   f o r   t h a t   w i d g e t   t y p e .   T h e   R o v i n g T a b I n d e x ( )   f u n c t i o n   d o e s   n o t   s u p p o r t   c h a i n i n g . 
 
 
 
 C o n f i g u r a t i o n 
 
 
 
     { 
 
         / /   R e q u i r e d :   D O M   n o d e   c o n t a i n e r   e l e m e n t   f o r   a s s o c i a t e d   c h i l d   n o d e s . 
 
         c o n t a i n e r :   d o m C o n t a i n e r E l e m e n t , 
 
 
 
         / /   R e q u i r e d :   A r r a y   o f   c h i l d   D O M   e l e m e n t s   t h a t   a r e   m e a n t   t o   b e   f o c u s a b l e . 
 
         / /   I m p o r t a n t :   I f   r e f e r e n c i n g   t h e   c h i l d r e n   o f   a n   A R I A   w i d g e t ,   t h e   a r r a y   m u s t   c o n t a i n   c h i l d   e l e m e n t s   t h a t   i n c l u d e   t h e   c o r r e c t   r o l e   a t t r i b u t e   v a l u e   f o r   t h a t   w i d g e t . 
 
         n o d e s :   d o m E l e m e n t A r r a y , 
 
 
 
         / /   O r i e n t a t i o n :   0   =   b o t h ,   1   =   h o r i z o n t a l ,   2   =   v e r t i c a l . 
 
         / /   D e f a u l t   i f   n o t   s p e c i f i e d :   0 
 
         o r i e n t a t i o n :   0 , 
 
 
 
         / /   A u t o   c o n f i g u r e   o r i e n t a t i o n   u s i n g   d y n a m i c   s w i t c h i n g   b a s e d   o n   t h e   v i s u a l   l a y o u t   o f   f o c u s a b l e   e l e m e n t s . 
 
         / /   " o f f " = I n a c t i v e ,   " s e m i " = S w i t c h e s   b e t w e e n   v e r t i c a l   a n d   h o r i z o n t a l   o n l y ,   " f u l l " =   S w i t c h e s   b e t w e e n   v e r t i c a l ,   h o r i z o n t a l ,   a n d   b o t h   w h e n   l i n e - w r a p p i n g   i s   d e t e c t e d . 
 
         a u t o S w i t c h :   " o f f " , 
 
 
 
         / /   S t a r t i n g   i n d e x   t o   m a k e   f o c u s a b l e   a f t e r   i n s t a n t i a t i o n . 
 
         / /   M a t c h e s   s t a r t i n g   i n d e x   t o   t h e   n o d e s   a r r a y ,   w h e r e   0   r e f e r e n c e s   t h e   f i r s t   e l e m e n t . 
 
         / /   D e f a u l t   i f   n o t   s p e c i f i e d :   0 
 
         s t a r t I n d e x :   0 , 
 
 
 
         / /   T r i g g e r i n g   e l e m e n t :   T h e   f o c u s a b l e   D O M   e l e m e n t   t h a t   t r i g g e r e d   t h i s   R T I   i n s t a n c e   i f   a p p l i c a b l e . 
 
         t r i g g e r :   d o m E l e m e n t , 
 
 
 
         / /   P a r e n t   R T I   i n s t a n c e 
 
         / /   W h e n   s e t ,   e n a b l e s   a u t o m a t i c   p a r e n t / c h i l d   R T I   i n s t a n c e   t r a c k i n g   t h r o u g h   t h e   e v e n t   h a n d l e r s . 
 
         / /   D e f a u l t   i f   n o t   s p e c i f i e d :   n u l l 
 
         p a r e n t :   n u l l , 
 
 
 
         / /   E n a b l e   a u t o   l o o p i n g 
 
         / /   W h e n   t r u e ,   a u t o m a t i c a l l y   l o o p s   f o r w a r d s   a n d   b a c k w a r d s   w h e n   t h e   a r r o w   k e y s   a r e   u s e d   t o   n a v i g a t e . 
 
         / /   D e f a u l t   i f   n o t   s e t :   f a l s e 
 
         a u t o L o o p :   f a l s e , 
 
 
 
         / /   O p t i o n a l   b r e a k p o i n t s   f o r   s e t t i n g   t h e   b o u n d a r i e s   o f   n a v i g a b l e   c o n s t r u c t s . 
 
         / /   M a y   b e   u s e d   t o   s e t   c o n s t r i c t e d   h o r i z o n t a l   o r   v e r t i c a l   b r e a k p o i n t s ,   o r   b o t h   a t   t h e   s a m e   t i m e   f o r   g r i d s . 
 
         b r e a k P o i n t :   { 
 
             / /   H o r i z o n t a l 
 
             / /   W h e n   s e t   t o   1   o r   g r e a t e r ,   r e p r e s e n t s   t h e   n u m b e r   o f   h o r i z o n t a l   m o v e s   a v a i l a b l e   w i t h i n   t h e   c o n s t r u c t ,   s u c h   a s   c o l u m n s   i n   a   r o w . 
 
             / /   M a y   b e   c o m b i n e d   w i t h   o r i e n t a t i o n   t o   f u r t h e r   r e s t r i c t   n a v i g a t i o n   i f   n e e d e d . 
 
             / /   D e f a u l t   i f   n o t   s p e c i f i e d :   0   ( d i s a b l e d ) 
 
             h o r i z o n t a l :   0 , 
 
 
 
             / /   V e r t i c a l 
 
             / /   W h e n   s e t   t o   1   o r   g r e a t e r ,   r e p r e s e n t s   t h e   n u m b e r   o f   v e r t i c a l   m o v e s   a v a i l a b l e   w i t h i n   t h e   c o n s t r u c t ,     s u c h   a s   r o w s   i n   a   g r i d . 
 
             / /   M a y   b e   c o m b i n e d   w i t h   o r i e n t a t i o n   t o   f u r t h e r   r e s t r i c t   n a v i g a t i o n   i f   n e e d e d . 
 
             / /   D e f a u l t   i f   n o t   s p e c i f i e d :   0   ( d i s a b l e d ) 
 
             v e r t i c a l :   0 , 
 
 
 
             / /   S e t   h a r d   s t o p   a t   h o r i z o n t a l   b r e a k p o i n t 
 
             / /   W h e n   s e t   t o   t r u e ,   p r e v e n t s   f u r t h e r   m o v e m e n t   b e y o n d   t h e   s p e c i f i e d   b r e a k p o i n t   w h e n   t h e   l e f t / r i g h t   a r r o w   k e y s   a r e   u s e d   t o   n a v i g a t e . 
 
             / /   D e f a u l t   i f   n o t   s p e c i f i e d :   f a l s e   ( n o   s t o p ) 
 
             h o r i z o n t a l S t o p :   f a l s e , 
 
 
 
             / /   S e t   h a r d   s t o p   a t   v e r t i c a l   b r e a k p o i n t 
 
             / /   W h e n   s e t   t o   t r u e ,   p r e v e n t s   f u r t h e r   m o v e m e n t   b e y o n d   t h e   s p e c i f i e d   b r e a k p o i n t   w h e n   t h e   u p / d o w n   a r r o w   k e y s   a r e   u s e d   t o   n a v i g a t e . 
 
             / /   D e f a u l t   i f   n o t   s p e c i f i e d :   f a l s e   ( n o   s t o p ) 
 
             v e r t i c a l S t o p :   f a l s e 
 
         } , 
 
 
 
         / /   O p t i o n a l l y   s e t   a   D C   o b j e c t   i n s t a n c e   t o   b e   a s s o c i a t e d   w i t h   t h i s   R T I   o b j e c t   i n s t a n c e . 
 
         / /   D e f a u l t   i f   n o t   s e t :   n u l l 
 
         D C :   n u l l , 
 
 
 
         / /   O p t i o n a l   e v e n t   h a n d l e r s 
 
 
 
         o n C l i c k :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n T o u c h S t a r t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n F o c u s :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n T a b :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t T a b :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n E n t e r :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l E n t e r :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t E n t e r :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t E n t e r :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n S p a c e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S p a c e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t S p a c e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t S p a c e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n L e f t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l L e f t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t L e f t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t L e f t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n A r r o w :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n R i g h t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l R i g h t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t R i g h t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t R i g h t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n E n d :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l E n d :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t E n d :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t E n d :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n H o m e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l H o m e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t H o m e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t H o m e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n E s c :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n D e l e t e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l D e l e t e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t D e l e t e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t D e l e t e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n P a g e U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n A l t P a g e U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l P a g e U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t P a g e U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t P a g e U p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         o n P a g e D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n A l t P a g e D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l P a g e D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n S h i f t P a g e D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
         o n C t r l S h i f t P a g e D o w n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { } , 
 
 
 
         / /   S p e c i a l   e v e n t   h a n d l e r s 
 
 
 
         o n O p e n :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e )   { 
 
             / /   A c t i v a t e s   w h e n   c l i c k e d ,   o r   w h e n   E n t e r   i s   p r e s s e d   o n   t r i g g e r N o d e . 
 
             / /   A l s o   w h e n   d o w n - a r r o w   i s   p r e s s e d   o n   a   h o r i z o n t a l   c o n s t r u c t ,   a n d   w h e n   r i g h t - a r r o w   i s   p r e s s e d   o n   a   v e r t i c a l   c o n s t r u c t .   ( U s e d   f o r   c o n f i g u r i n g   A R I A   m e n u s   a n d   t r e e s . ) 
 
         } , 
 
 
 
         o n C l o s e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e )   { 
 
             / /   A c t i v a t e s   w h e n   E s c a p e   i s   p r e s s e d   o n   t r i g g e r N o d e . 
 
             / /   A l s o   w h e n   u p - a r r o w   i s   p r e s s e d   o n   a   h o r i z o n t a l   c o n s t r u c t ,   a n d   w h e n   l e f t - a r r o w   i s   p r e s s e d   o n   a   v e r t i c a l   c o n s t r u c t .   ( U s e d   f o r   c o n f i g u r i n g   A R I A   m e n u s   a n d   t r e e s . ) 
 
         } , 
 
 
 
         o n T o p :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e )   { 
 
             / /   A c t i v a t e s   w h e n   t h e   b e g i n n i n g   b o u n d a r y   i s   f i r e d   w h i l e   u s i n g   t h e   L e f t   o r   U p   a r r o w   k e y s   t o   n a v i g a t e . 
 
         } , 
 
 
 
         o n B o t t o m :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e )   { 
 
             / /   A c t i v a t e s   w h e n   t h e   e n d i n g   b o u n d a r y   i s   f i r e d   w h i l e   u s i n g   t h e   R i g h t   o r   D o w n   a r r o w   k e y s   t o   n a v i g a t e . 
 
         } , 
 
 
 
         o n B o u n d s :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   k e y C o d e )   { 
 
             / /   A c t i v a t e s   w h e n   t h e   b r e a k P o i n t   b o u n d a r y   i s   f i r e d   w h i l e   u s i n g   t h e   a r r o w   k e y s   t o   n a v i g a t e . 
 
             / /   k e y C o d e   m a t c h e s   t h e   e v e n t . w h i c h   v a l u e   f o r   t h e   p r e s s e d   k e y .   ( U s e d   f o r   c o n f i g u r i n g   A R I A   g r i d s . ) 
 
             / /   3 7   =   L e f t A r r o w ,   3 8   =   U p A r r o w ,   3 9   =   R i g h t A r r o w ,   4 0   =   D o w n A r r o w 
 
         } , 
 
 
 
         o n S e l e c t A l l :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             / /   A c t i v a t e s   w h e n   C t r l + A   i s   p r e s s e d   o n   t h e   k e y b o a r d . 
 
         } , 
 
 
 
         o n C o p y :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             / /   A c t i v a t e s   w h e n   C t r l + C   i s   p r e s s e d   o n   t h e   k e y b o a r d . 
 
         } , 
 
 
 
         o n C u t :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             / /   A c t i v a t e s   w h e n   C t r l + X   i s   p r e s s e d   o n   t h e   k e y b o a r d . 
 
         } , 
 
 
 
         o n P a s t e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             / /   A c t i v a t e s   w h e n   C t r l + V   i s   p r e s s e d   o n   t h e   k e y b o a r d . 
 
         } 
 
 
 
     } 
 
 
 
 R T I   P r o p e r t i e s   a n d   M e t h o d s 
 
 
 
 T h e   f o l l o w i n g   p r o p e r t i e s   a n d   m e t h o d s   a r e   a v a i l a b l e   a f t e r   a n   R T I   o b j e c t   i n s t a n c e   i s   c r e a t e d . 
 
 
 
 P r o p e r t i e s 
 
 
 
 / /   T h e   D O M   n o d e   s p e c i f i e d   a s   t h e   p a r e n t   c o n t a i n e r   e l e m e n t .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   O b j e c t   t y p e :   d o m E l e m e n t 
 
     R T I . c o n t a i n e r 
 
 
 
 / /   T h e   a r r a y   o f   D O M   n o d e s   t h a t   a r e   m e a n t   t o   b e   f o c u s a b l e .   ( M a t c h e s   t h o s e   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   I f   c h a n g e d   p r o g r a m m a t i c a l l y ,   t h e   R T I . o n ( )   m e t h o d   m u s t   b e   c a l l e d   t o   r e a s s o c i a t e   t h e   n e w   n o d e   l i s t   w i t h   r e q u i r e d   e v e n t   b i n d i n g s . 
 
 / /   O b j e c t   t y p e :   A r r a y 
 
     R T I . n o d e s 
 
 
 
 / /   C u r r e n t   v a l u e   s e t   a s   t h e   k e y b o a r d   n a v i g a t i o n   o r i e n t a t i o n .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   0   =   b o t h   h o r i z o n t a l   a n d   v e r t i c a l ,   1   =   h o r i z o n t a l ,   a n d   2   =   v e r t i c a l . 
 
 / /   O b j e c t   t y p e :   N u m b e r 
 
     R T I . o r i e n t a t i o n 
 
 
 
 / /   I n d e x   v a l u e   o f   t h e   c u r r e n t l y   a c t i v e   f o c u s a b l e   e l e m e n t   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   U s e s   a r r a y   s y n t a x   w h e r e   0   =   t h e   f i r s t   n o d e   i n   t h e   a r r a y . 
 
 / /   D o   n o t   u s e   t h i s   p r o p e r t y   t o   c h a n g e   t h e   a c t i v e   n o d e ,   b u t   i n s t e a d   u s e   t h e   R T I . a c t i v a t e ( )   o r   R T I . f o c u s ( )   m e t h o d s   f o r   t h i s   p u r p o s e . 
 
 / /   O b j e c t   t y p e :   N u m b e r 
 
     R T I . i n d e x 
 
 
 
 / /   T h e   p a r e n t   R T I   i n s t a n c e   a s s o c i a t e d   w i t h   t h e   c u r r e n t   R T I   o b j e c t   i n s t a n c e .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   O b j e c t   t y p e :   R T I   o b j e c t   i n s t a n c e 
 
     R T I . p a r e n t 
 
 
 
 / /   M a p   o f   c h i l d   R T I   o b j e c t s   t h a t   a r e   b o u n d   t o   s p e c i f i c   t r i g g e r i n g   e l e m e n t s   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   T h e   t r i g g e r i n g   e l e m e n t   i s   t h e   k e y   f o r   r e t r e i v i n g   t h e   a s s o c i a t e d   c h i l d   R T I   o b j e c t   i n s t a n c e . 
 
 / /   T h i s   i s   a u t o m a t i c a l l y   c o n f i g u r e d   w h e n   1   o r   m o r e   R T I   i n s t a n c e s   a r e   b o u n d   u s i n g   t h e   p a r e n t   p r o p e r t y   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p   d u r i n g   s e t u p . 
 
 / /   O b j e c t   t y p e :   M a p   o b j e c t 
 
     R T I . c h i l d r e n 
 
 
 
 / /   T h e   t r i g g e r i n g   e l e m e n t   t h a t   i s   s p e c i f i e d   a s   t h e   c o n t r o l l e r   f o r   t h e   c u r r e n t   R T I   o b j e c t   i n s t a n c e .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   I f   t h e   t r i g g e r i n g   e l e m e n t   i s   i n c l u d e d   w i t h i n   t h e   R T I . n o d e s   a r r a y   o f   a   p a r e n t   R T I   i n s t a n c e ,   t h e   p a r e n t   c h i l d   m a p p i n g s   w i l l   b e   s e t   a u t o m a t i c a l l y . 
 
 / /   O b j e c t   t y p e :   d o m E l e m e n t 
 
     R T I . t r i g g e r 
 
 
 
 / /   T h e   c u r r e n t   s e t t i n g   o f   a u t o m a t i c   l o o p   f u n c t i o n a l i t y .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   O b j e c t   t y p e :   B o o l e a n 
 
     R T I . a u t o L o o p 
 
 
 
 / /   T h e   D C   o b j e c t   i n s t a n c e   a s s o c i a t e d   w i t h   t h e   c u r r e n t   R T I   o b j e c t   i n s t a n c e   i f   a p p l i c a b l e .   ( M a t c h e s   t h a t   s p e c i f i e d   w i t h i n   t h e   c o n f i g u r a t i o n   k e y   v a l u e   m a p . ) 
 
 / /   O b j e c t   t y p e :   D C   o b j e c t   i n s t a n c e 
 
     R T I . d c 
 
 
 
 M e t h o d s 
 
 
 
 / /   A c t i v a t e   t h e   s p e c i f i e d   e l e m e n t   w i t h i n   t h e   R T I . n o d e s   a r r a y   a n d   s e t   t h i s   a s   t h e   c u r r e n t l y   f o c u s a b l e   e l e m e n t . 
 
 / /   T h e   f i r s t   p a r a m e t e r   m u s t   c o n t a i n   a   v a l i d   i n d e x   v a l u e ,   o r   a   d o m E l e m e n t   r e f e r e n c e   t h a t   a l r e a d y   e x i s t s   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   T h i s   m e t h o d   w i l l   s e t   f o c u s a b i l i t y   f o r   t h e   s p e c i f i e d   e l e m e n t ,   b u t   w i l l   n o t   m o v e   f o c u s   d i r e c t l y . 
 
 / /   R e t u r n s :   R T I   o b j e c t   i n s t a n c e 
 
     R T I . a c t i v a t e ( r e q u i r e d I n d e x V a l u e O r E l e m e n t N o d e ) 
 
 
 
 / /   A c t i v a t e   a n d   m o v e   f o c u s   t o   t h e   s p e c i f i e d   e l e m e n t   w i t h i n   t h e   R T I . n o d e s   a r r a y   a n d   s e t   t h i s   a s   t h e   c u r r e n t   e l e m e n t . 
 
 / /   T h e   f i r s t   p a r a m e t e r   m a y   o p t i o n a l l y   c o n t a i n   a   v a l i d   i n d e x   v a l u e ,   o r   a   d o m E l e m e n t   r e f e r e n c e   t h a t   a l r e a d y   e x i s t s   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   I f   n o   p a r a m e t e r   i s   s p e c i f i e d ,   t h e   c u r r e n t l y   a c t i v e   e l e m e n t   w i t h i n   t h e   R T I   o b j e c t   i n s t a n c e   w i l l   r e c e i v e   f o c u s   i n s t e a d . 
 
 / /   R e t u r n s :   R T I   o b j e c t   i n s t a n c e 
 
     R T I . f o c u s ( o p t i o n a l I n d e x V a l u e O r E l e m e n t N o d e ) 
 
 
 
 / /   R e m o v e   a l l   R T I   e v e n t   b i n d i n g s . 
 
 / /   T h i s   w i l l   n o t   d e s t r o y   t h e   R T I   o b j e c t ,   b u t   w i l l   i n s t e a d   r e m o v e   a l l   o f   t h e   R T I   r e l a t e d   e v e n t   b i n d i n g s   f r o m   a l l   e l e m e n t s   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   R e t u r n s :   R T I   o b j e c t   i n s t a n c e 
 
     R T I . o f f ( ) 
 
 
 
 / /   R e c r e a t e   a l l   R T I   e v e n t   b i n d i n g s . 
 
 / /   T h i s   w i l l   n o t   c r e a t e   a   n e w   R T I   i n s t a n c e ,   b u t   w i l l   i n s t e a d   r e b u i l d   a l l   o f   t h e   R T I   r e l a t e d   e v e n t   b i n d i n g s   f o r   a l l   e l e m e n t s   w i t h i n   t h e   R T I . n o d e s   a r r a y . 
 
 / /   R e t u r n s :   R T I   o b j e c t   i n s t a n c e 
 
     R T I . o n ( ) 
 
 
 
 E x a m p l e : 
 
 
 
 $ A . i m p o r t ( " R o v i n g T a b I n d e x " ,   {   d e f e r :   t r u e   } ,   f u n c t i o n ( )   { 
 
 
 
     v a r   m y R T I   =   n e w   $ A . R o v i n g T a b I n d e x ( { 
 
         c o n t a i n e r :   $ A . g e t E l e m e n t ( " t a b L i s t I d " ) ,   / /   G e t   p a r e n t   w i t h   r o l e = " t a b l i s t " 
 
 
 
         / /   G e t   c h i l d r e n   w i t h   r o l e = " t a b " 
 
         n o d e s :   $ A . q u e r y ( ' # t a b L i s t I d   * [ r o l e = " t a b " ] ' ) , 
 
 
 
         o r i e n t a t i o n :   1 , 
 
         a u t o S w i t c h :   " f u l l " , 
 
 
 
         a u t o L o o p :   t r u e , 
 
 
 
         o n C l i c k :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             / /   O p e n   t h e   s p e c i f i e d   t a b   w h e n   c l i c k e d . 
 
         } , 
 
 
 
         o n E n t e r :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             m y R T I . o n C l i c k . c a l l ( t h i s ,   e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ) ; 
 
         } , 
 
 
 
         o n S p a c e :   f u n c t i o n ( e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ,   a r r o w K e y C o d e ,   i s T o p ,   i s B o t t o m )   { 
 
             m y R T I . o n C l i c k . c a l l ( t h i s ,   e v e n t ,   t r i g g e r N o d e ,   c u r r e n t R T I ,   c h i l d D C ) ; 
 
         } , 
 
 
 
     } ) ; 
 
 
 
 } ) ; 
 
 